home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / p2f100.zip / P2F.DOC < prev    next >
Text File  |  1992-08-02  |  6KB  |  181 lines
  1.  
  2.  
  3.       PCBoard to Files.BBS Directory Conversion Utility (P2F) Version 1.00
  4.  
  5.                (c)1992 7th Illusion, J.S. Morisset aka Storm Widow
  6.                                All Rights Reserved
  7.  
  8.                             Released August 2nd, 1992
  9.  
  10.      1.  License Agreement
  11.  
  12.          P2F  is released  under the  Shareware concept.   As such,  you may
  13.          distribute P2F freely,  provided you do not  charge copying, or any
  14.          distribution  fees; an  exception is  granted to  non-profit user's
  15.          groups, which are  permitted to charge  a small fee  (not to exceed
  16.          $5.00 U.S.) for materials, handling, postage, and general overhead.
  17.          No  other  organization  is  permitted  to  charge  any  amount for
  18.          distribution  of copies  of the  software  or documentation,  or to
  19.          include copies of the software or documentation with sales of their
  20.          own products.  You may not alter,  modify, or adapt the software or
  21.          documentation,   including,   but  not   limited   to  translating,
  22.          decompiling, reverse assembling, or creating derivative works.
  23.  
  24.          You may use P2F free of  charge for a thirty day evaluation period,
  25.          after which you  are expected to register  or discontinue using the
  26.          program.  Registration permits continued use  on a regular basis on
  27.          a single  computer.  A  registered user  may use  the program  on a
  28.          different computer, but  may not use  the program on  more than one
  29.          computer at the  same time.  Registration  includes licensed use of
  30.          all upgrades.
  31.  
  32.          To  register,  send $10.00  (CDN  funds)  in check  or  money order
  33.          payable to  7th Illusion  (no cash  please) at  the mailing address
  34.          listed bellow.
  35.  
  36.      2.  Disclaimer of Warranty
  37.  
  38.          THIS SOFTWARE AND  MANUAL ARE PROVIDED "AS  IS" WITHOUT WARRANTY OF
  39.          ANY KIND, EITHER  EXPRESSED OR IMPLIED,  INCLUDING, BUT NOT LIMITED
  40.          TO,  THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS OF
  41.          PURPOSE.  THE USER  OF THIS SOFTWARE AND  MANUAL ASSUMES ALL RISKS.
  42.          SHOULD  P2F OR  ITS ASSOCIATED  DOCUMENTATION PROVE  DEFECTIVE, YOU
  43.          ASSUME THE COSTS OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
  44.  
  45.      3.  Contacting the Author
  46.  
  47.          Netmail and/or E-Mail
  48.  
  49.          Fidonet       1:167/281
  50.          Internet      storm.widow@f281.n167.z1.fidonet.org
  51.          Compuserve    >INTERNET:storm.widow@f281.n167.z1.fidonet.org
  52.          BBS           (514) 338-1193, 14400 HST
  53.                        (514) 338-1680, 2400 Generic
  54.  
  55.          Surface Mail
  56.  
  57.                         7th Illusion
  58.                         Post Office Box 1334, Station H
  59.  
  60.      
  61.  
  62.  
  63.                         Montreal QC, Canada
  64.                         H3G 2N6
  65.      Introduction
  66.  
  67.          P2F  is  designed  to  convert  your  PCBoard  file  directories to
  68.          FILES.BBS format  (QBBS/RA/Opus/etc).  This enables  SysOps to make
  69.          use  of several  Fidonet  utilities including  FREQ  doors, Netmail
  70.          command processors, FILES.BBS filelist and bulletin compilers, etc.
  71.  
  72.          I've purposefully made P2F very simple to use, needing little or no
  73.          maintenance as  your file  directories change.   Personally, I hate
  74.          re-configuring a  dozen utilities just  because I  changed or added
  75.          something in PCBoard.
  76.  
  77.      Limitations
  78.  
  79.          If you ever need P2F to do more than it does, send me a message and
  80.          I'll be happy to add some new features.  The following limits could
  81.          be exceeded, the only result is that P2F will exit with an error.
  82.  
  83.          ■  P2F will handle any conference  between 0 and 39 inclusively.  I
  84.             don't expect anyone  would have file  directories in conferences
  85.             higher than 39.  If you do, send  a message and I'll spend a few
  86.             more hours to work in support for the CNAMES.@@@ file.
  87.  
  88.          ■  Maximum of 500 directory entries in DIR.LST.  This limit was set
  89.             to conserve memory and speed-up P2B's execution speed.
  90.  
  91.      Usage
  92.  
  93.          Like I said, I like to keep my programs simple; all that's involved
  94.          here is giving  the path/filename to your  PCBOARD.DAT file and the
  95.          conference number to process.
  96.  
  97.          ie:  P2F.EXE /p<pcboard.dat> /c<cnfn#>
  98.               P2F.EXE /pD:\PCB0\PCBOARD.DAT /c4
  99.  
  100.          These same examples  are displayed if you  call P2F.EXE without any
  101.          parameters.  In case  of errors (missing files,  etc) P2F will exit
  102.          with one of these errorlevels.
  103.  
  104.               (0) Normal Termination
  105.               (1) Error Opening File
  106.               (2) Unexpected EOF or Out-Of-Sync
  107.               (3) Array Bounds Exceeded
  108.  
  109.      Run-Time
  110.  
  111.          P2F will read your PCBOARD.DAT to  locate the CNAMES file.  It will
  112.          then scan CNAMES for the path/filename of the conference's DIR.LST.
  113.          Following is a sample DIR.LST I used during development:
  114.  
  115.               DIR Text File Name & Path       Hard Disk Subdirectory
  116.               ═════════════════════════       ══════════════════════
  117.               E:\MTLN\CYBERNT\DIRS\FIDOINFO   F:\CYBERNT\FIDOINFO\
  118.               E:\MTLN\CYBERNT\DIRS\FIDOFEND   F:\CYBERNT\FIDOFEND\
  119.  
  120.      
  121.  
  122.  
  123.               E:\MTLN\CYBERNT\DIRS\FIDOMSGS   F:\CYBERNT\FIDOMSGS\
  124.               E:\MTLN\CYBERNT\DIRS\FIDONODE   F:\CYBERNT\FIDONODE\
  125.               E:\MTLN\CYBERNT\DIRS\FIDO_FDN   F:\CYBERNT\FIDO_FDN\
  126.               etc.
  127.  
  128.          As you'll notice, each DIR file  has an individual directory on the
  129.          hard-drive.   This  is the  suggested  configuration  for PCBoard's
  130.          maximum efficiency  (file search speed).   This is  also the =ONLY=
  131.          way P2F will function properly.  If  two DIR entries share the same
  132.          physical directory, the last FILES.BBS will over-write the previous
  133.          one.
  134.  
  135.          Continuing  the  example above,  you'll  find a  FILES.BBS  in each
  136.          physical directory after P2F's execution.
  137.  
  138.               F:\CYBERNT\FIDOINFO\FILES.BBS
  139.               F:\CYBERNT\FIDOFEND\FILES.BBS
  140.               F:\CYBERNT\FIDOMSGS\FILES.BBS
  141.               F:\CYBERNT\FIDONODE\FILES.BBS
  142.               F:\CYBERNT\FIDO_FDN\FILES.BBS
  143.               etc.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      
  181.